home *** CD-ROM | disk | FTP | other *** search
/ Mac Magazin/MacEasy 21 / Mac Magazin and MacEasy Magazine CD - Issue 21.iso / Wissenschaft & Technik / yorick_docs folder / gist-1.2vr1-README next >
Text File  |  1996-02-29  |  5KB  |  107 lines
  1. Introduction
  2. ------------
  3. Gist is a program that displays frames in binary CGM files written by
  4. yorick and other applications (e.g. ATC GKS, IDL). gist is
  5. particularly useful for making PICT files from a CGM file written by
  6. a Unix version of yorick. 
  7.  
  8. Yorick is a tool for analyzing numerical data. It has an interpreter
  9. that uses a C-like language and can operate on entire arrays without
  10. any need for do loops over the array indices. Yorick has a file I/O
  11. package with the ability to conveniently read text files with
  12. columns of numbers. The file I/O package can easily be trained to
  13. read a wide variety of binary and text files, if the formatting
  14. rules for the file are known. Yorick has a 2D graphics package that
  15. includes polylines, contour plots, cell arrays, and filled mesh
  16. plots. The new 3D graphics package provides surface plots, slicing
  17. planes, and iso-surfaces.
  18.  
  19. The Macintosh version of Gist was created by Steve Langer
  20. (shl@icf.llnl.gov) from the Unix version written by Dave Munro.
  21. This file contains some short notes about the Macintosh version.
  22. Usage of the Mac version is largely self-explanatory.  If you want to
  23. find out about more details, please consult the documentation
  24. supplied with the Unix version.
  25.  
  26. Macintosh versions of Yorick and Gist are labeled by the version
  27. number of the corresponding Unix release followed by the Mac version.
  28. For example, version 1.2v1 means the first version based on Unix
  29. release 1.2.
  30.  
  31.  
  32. Bug fixes and New Features in release 1.2vr1
  33. --------------------------------------------
  34. There are now both 68000 and Power PC versions of gist.
  35.  
  36. Previous versions of macgist did not correctly display polygons
  37. with more than 98 vertices. The new limit should be large enough
  38. that you will never encounter it. 
  39.  
  40. If you double-click on a cgm file created by yorick, gist will be 
  41. launched. At this time, gist does not manage to open the cgm file, 
  42. but that should be fixed soon. 
  43.  
  44.  
  45. Usage Notes
  46. -----------
  47. Gist reads binary CGM files and displays the plots on the screen. 
  48. Gist can save any desired combination of plots from the CGM file 
  49. in another CGM file or in a PostScript file. The Mac version of 
  50. gist can also save the currently displayed frame in a PICT file. 
  51.  
  52. CGM stands for "Computer Graphics Metafile". The CGM standard was
  53. originally developed for mainframe computer graphics, but it is now
  54. used on computers of all sizes, and even is used by some mainstream
  55. programs like Freelance Graphics by Lotus  Development. One of the
  56. unfortunate features of the CGM standard is that it provides many
  57. options for how to encode a file. gist does not attempt to read all
  58. CGM files. gist can read the  CGM files written by yorick without any
  59. loss of information. The preferences dialog in the edit menu provides
  60. an option to read cgm files made by the ATC GKS package, and this works
  61. reasonably for the files we make using ATC. Gist may work with other 
  62. types of binary cgm files, so go ahead and try it and see what happens.
  63.  
  64. The main use for macgist is making PICT files from a CGM file written by
  65. yorick. A specific case where it would be extremely useful is when 
  66. you have run a complex calculation with yorick on a Unix workstation
  67. and need to include the results in report written on a Macintosh.
  68.  
  69. An open dialog in gist shows files that have type CGMF or files whose
  70. name ends in ".cgm". Gist does not show files with two or more "dots"
  71. in their names, even if the name ends in ".cgm". This is on the list to
  72. be fixed someday.
  73.  
  74. If a frame in your file seems to be drawn twice every time you move to
  75. it, it is probably because a new color table is loaded as part of that
  76. frame. At some point I would like to modify macgist so that this redraw
  77. does not happen, but you will have to accept it for now.
  78.  
  79. Although a check box in the preferences dialog suggests that you can
  80. turn on command-period interrupts, this version of macgist does not
  81. actually support them.
  82.  
  83. The save window size button in the preferences dialog does not work due
  84. to problems with the FaceIt library. I hope to fix this in a future
  85. version.
  86.  
  87.  
  88. Getting Gist
  89. ------------
  90. Gist is distributed in two self-extracting archive files. There is a
  91. version that runs on any 68000 based Mac and a Power Mac version.
  92. Each version of gist checks for the Mac hardware and software it
  93. requires and aborts if it is not found (it is possible that detection
  94. of old 68000 Macs does not work).
  95.  
  96. If you have a copy of yorick, you may drag the gist application into
  97. the yorick folder and throw out the rest of the gist folder.
  98.  
  99. If you can do so, download the "sea" file in MacBinary mode with your
  100. ftp program. If the ftp site you are using only has the "hqx"
  101. version, download it and use a program like UnStuffIt to decode the
  102. BinHex file. Once you have the "sea" file, double-click on it and it
  103. will automatically  split itself apart into the constituent files. If
  104. you install both yorick and gist, you can drag the gist application
  105. into the yorick folder and throw away the gist sub-folder in the main
  106. gist folder.
  107.